## variables commented out with a single #hash represent default values.
##
## Since PicoPygments has no dependencies PicoCMS will enable it by default.
## You can disable it by setting this to false:
##
PicoPygments:
    enabled: true

    ## Class to use for code blocks with language definitions.
    ## Additionally, the "language-$lang" class is preserved.
    #cssclass: "pcpg"

    ## Template to activate this plugin for. Pass "all" to activate for all pages.
    ## (Nevertheless, this plugin only springs into action when a code block with
    ## a language definition is found.)
    #template: "post"

    ## Add a link to this CSS.
    ## This will override any tagblog.colors set in PicoCMS' config.
    ## You can find a choice of styles in the plugin's css directory,
    ## generated with the styles.py script therein.
    ## Each color CSS also imports _common.css from the same folder.
    #stylesheet: "/plugins/PicoPygments/css/generated/base16-equilibrium-dark-var.css"

    ## Use this as your python command.
    ## If you can, try to minimize resource usage, e.g.: python_cmd: "/usr/bin/python3m -I"
    #python_cmd: "python3 -I"
    python_cmd: "python3 -s -I"

    ## An existing directory to cache pygments-generated results. This highly reduces
    ## page loading times since python isn't called at all if all code blocks have been cached already.
    ## Make sure this is set to a path the web server has permissions to read+write. The directory and
    ## parents will be created as required. But the plugin works just fine without caching, too.
    cache_dir: "/dev/shm/cache/pico-staging/PicoPygments"

    ## Inserts a <div class="corner"> between the <pre> and the <code> element. It contains the language of the code block.
    ## This can be pushed to the top right corner of the code block (see css/_common.css). Set it to true or false.
    label: true

    ## If you set 'debug: true' in your main config.yml, the plugin will spew out debug messages.
    ## If you set the below to true, it will spew out _much_ more - including raw html output.
    #debug_xtra: false

## DANGER ZONE
    ## We pass options to the Pygments lexer (what parses the code) and the HTML formatter.
    ## If you want - and are sure you know what you're doing - you can change the whole
    ## optionstring for both. Here are the defaults:

    #lexeroptions: 'encoding="utf-8"'
    #formatteroptions: 'nowrap=True'

    ## Please refer to https://pygments.org/docs/lexers/ and https://pygments.org/docs/formatters/#HtmlFormatter
